Developer Documentation

QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Caps

Labels

ASCII
Caps
Binary
caps ( = 0x63617073 )

caps flags

None                0x00000000
Top                 0x00000001
Bottom              0x00000002

Constant descriptions

None
The parent cone or cylinder shall not have any caps.
Top
The parent cylinder shall have a cap at the end opposite to its base.
Bottom
The parent cone or cylinder shall have a cap at its base.

Data Format

CapsFlags           caps
caps
A bitfield expression specifying one or more flags.

Data Size

4

Description

A cap is a plane figure having the shape of an oval that closes the base of a cone or one end of a cylinder. A cone and a cylinder may each be supplied with a bottom cap. Only a cylinder may be supplied with a top cap. The length of the semimajor axis of a cap is equal to the length of the major radius of its parent object; the length of the semiminor axis of a cap is equal to the length of the minor radius of its parent object. A cap lies in a plane perpendicular to the orientation vector of its parent object. The center of a top cap is at the end of the orientation vector of its parent object; the center of a bottom cap is at the origin of its parent object. A separate attribute set may be assigned to each cap of an object having one or more caps.

Parent Hierarchy

Data, cap data.

Parent Objects

Cone, cylinder (always).

Child Objects

None.

Example

Container (
    Cone ( ... )
    Caps ( Top | Bottom )
    Container (
        BottomCapAttributeSet ( )
        DiffuseColor ( 0 1 0 )
    )
)

Default Value

None.


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |